CCCCCCCCCCCC
CCCCCCCCCCCC
CCCC
CCCC   ooooooo
CCCC   oo   oo  nnn
CCCC   oo   oo  n n t r i b u t e d  Library for the Agilent ChemStation
CCCC   oo   oo  n n
CCCC   ooooooo
CCCC
CCCCCCCCCCCC
CCCCCCCCCCCC



Agilent ChemStation Revision A.06.01 and higher
Date 4-Apr-99
LC/MS Macro Contribution #5
Contribution 'Chromatogram Signal-Noise Macro'



Revision History
----------------

1. A.01  Version for ChemStation A.06.01 4-Apr-99
    	    Adapted from sig_n.mac (GC/MS software)



Contribution Purpose
--------------------
	
This is a macro to calculate both the peak-to-peak 
and RMS signal-to-noise of the selected chromatogram.

The macro adds a menu item (UCL, Chromatogram S/N >) to 
the ChemStation's Data Analysis menu.  



Contribution Structure
----------------------

  One macro file:
	CHROMSN.MAC

  One help file:
	CHROMSN.HLP

  This file:
	README.TXT



Prerequisites
-------------

  - MS Windows NT 4.0 as required by the revision of the 
          ChemStation in use
  - The ChemStation software, Rev A.06.01 or higher



Installation
------------

- Copy macro files CHROMSN.MAC and CHROMSN.HLP to the 
	ChemStation's executable directory, 'C:\chem32\CORE'
	by default.     



Uninstalling The Macro
------------------------------------------------------------

Exit Chemstation and remove any reference to CHROMSN.MAC from
the USER.MAC file.



Use
---

Load and start the macro with:

   macro CHROMSN.MAC, go

The macro will add a menu item (UCL, Chromatogram S/N >) to the menu
in the 'Data Analysis' view.

Use this menu item to select the chromatogram to be used in the S/N
calculation from the current data file through the Select 
Chromatogram dialog.  

Select the Signal Region and the Noise Region from the respective 
windows.  A report will be displayed in a report viewer, and may be
printed from the viewer.



Operation Overview
------------------

Select Chromatogram dialog - Use this dialog to select the 
chromatogram to use in the S/N calculation.  

  'Select the Chromatogram' List Box - Select the chromatogram here
	to be used in the S/N calculation.  All chromatograms
	currently available in the data file are listed for
	selection.  The user may also choose 'User Selected EIC'
	and enter the mass range to be used in the appropriate
	edit boxes described below.  The specified EIC will be
	automatically loaded.
  	
  'User Selected EIC' Group Box - Enter the starting and ending
	mass ranges used for EIC extraction when 'User Selected EIC'
	is chosen in the Select the Chromatogram list box.

  Starting Mass - for EIC. Default: 1. Range 1 - 999999.
  Ending Mass - for EIC. Default: 999. Range 1 - 999999.

'Select Signal Region' Window - This window is automatically 
created on 'OK' exit of the 'Select the Chromatogram' dialog.
Use this window to select the 'signal" region of the chromato-
gram used in the calculations.

  Zoom - Use left-click and drag to zoom in, left-double-click
	to zoom out one level.  You may zoom in as many times
	as is required to select the desired signal region.
  Accept - Use <ctrl>left-click to accept the displayed region
	of the chromatogram as the signal region.  The region
	accepted for use as the signal region will be indicated
	in this window with a shaded background.

'Select Noise Region' Window - This window is automatically 
created on 'OK' exit of the 'Select the Chromatogram' dialog.
Use this window to select the 'noise' region of the chromato-
gram used in the calculations.

  Zoom - Use left-click and drag to zoom in, left-double-click
	to zoom out one level.  You may zoom in as many times
	as is required to select the desired noise region.
  Accept - Use <ctrl>left-click to accept the displayed region
	of the chromatogram as the noise region.  The region
	accepted for use as the noise region will be indicated
	in this window with a shaded background.

'Signal-to-Noise Report' Window - This window is automatically
created once a signal region and noise region have been 
selected and accepted.  It contains a preview of the S/N report
including: data file information, graphics of the signal and
noise regions selected, and the S/N calculations.  If the signal
or noise region is re-selected, the report is re-generated based
on the new data.  Use this window to preview the S/N results before
printing.

Use the menu item 'UCL, Chromatogram S/N, End S/N Macro' to 
close all S/N associated windows and the report viewer.
	


System File Modification For Automatic Macro Loading:
------------------------------------------------------------

Append (cut/paste) the following lines to the end of the 
		USER.MAC file.



!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
! Loads CHROMSN.MAC - Chromatogram S/N Macro        !
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

MACRO "CHROMSN.MAC"

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!